/* ===================

AX2E (AXESCON XACML 2.0 Engine) is the Java authorization engine, which implements OASIS XACML 2.0 standard.
Copyright (C) 2007 AXESCON LLC

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA


Contact: AXESCON LLC - info{at}axescon.com

 =================== */
package axescon.xacml.api;

import axescon.xacml.model.ctx.Response;

import java.io.Writer;
import java.io.OutputStream;

/**
 * @author argyn
 * Date: Oct 24, 2005
 *         Responsibilities:  serializes XACML Response into output stream.
 * This is a generic interface
 * for serializers, which serialze XACML Response objects to files or other serialized text sources.
 */
public interface ResponseSerializer {
     /**
      * writes serialized XACML Response to OutputStream. this <strong>closes</strong> the OutputStream.
      * @param os OutputStream
      * @param resp   XACML response
      * @throws Exception
      */
    void writeResponse(OutputStream os, Response resp) throws Exception;

    /**
     * sets default configuration parameters
     */
    void setDefaults();
}
